package com.yunxi.module.system.service.permission;

import com.yunxi.framework.common.pojo.PageResult;
import com.yunxi.module.system.model.permission.RoleDO;
import com.yunxi.module.system.vo.admin.permission.role.RolePageReqVO;
import com.yunxi.module.system.vo.admin.permission.role.RoleSaveReqVO;

import java.util.Collection;
import java.util.List;
import java.util.Set;

/**
 * <p>
 * 角色 Service
 * </p>
 *
 * @author lidy
 * @since 2024-05-07
 */
public interface RoleService {

    /**
     * 判断角色编号数组中，是否有管理员
     *
     * @param ids 角色编号数组
     * @return 是否有管理员
     */
    boolean hasAnySuperAdmin(Collection<Long> ids);

    /**
     * 从缓存中获得角色
     *
     * @param id 角色 ID
     * @return 角色
     */
    RoleDO getRoleFromCache(Long id);

    /**
     * 获得角色列表
     *
     * @param roleIds 角色编号数组
     * @return 角色列表
     */
    List<RoleDO> getRoleList(Collection<Long> roleIds);

    /**
     * 从缓存中获得角色数组
     *
     * @param ids 角色编号数组
     * @return 角色数组
     */
    List<RoleDO> getRoleListFromCache(Collection<Long> ids);

    /**
     * 根据状态查询角色集合
     *
     * @param statuses 状态集合
     * @return 角色集合
     */
    List<RoleDO> getRoleListByStatus(Collection<Integer> statuses);

    /**
     * 获得角色分页列表
     *
     * @param reqVO 分页参数
     * @return 角色分页列表
     */
    PageResult<RoleDO> getRolePage(RolePageReqVO reqVO);

    /**
     * 根据角色编号获得角色信息
     *
     * @param roleId 角色编号
     * @return 角色信息
     */
    RoleDO getRole(Long roleId);

    /**
     * 删除角色
     *
     * @param roleId 角色编号
     */
    void deleteRole(Long roleId);

    /**
     * 创建角色信息
     *
     * @param createReqVO 角色信息
     * @param type        角色类型
     * @return 角色编号
     */
    Long createRole(RoleSaveReqVO createReqVO, Integer type);

    /**
     * 修改角色
     *
     * @param updateReqVO 角色信息
     */
    void updateRole(RoleSaveReqVO updateReqVO);

    /**
     * 修改角色状态
     *
     * @param roleId 角色编号
     * @param status 状态
     */
    void updateRoleStatus(Long roleId, Integer status);

    /**
     * 为角色分配数据权限
     *
     * @param roleId           角色编号
     * @param dataScope        数据权限
     * @param dataScopeDeptIds 数据权限部门编号
     */
    void updateRoleDataScope(Long roleId, Integer dataScope, Set<Long> dataScopeDeptIds);

    /**
     * 获得所有角色
     *
     * @return 所有角色列表
     */
    List<RoleDO> getRoleList();
}
